home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro143 / qcom.doc < prev    next >
Encoding:
Text File  |  1993-02-16  |  47.7 KB  |  1,096 lines

  1.                                     
  2.    
  3.    
  4.    
  5.    
  6.    
  7.        QCOM.EXE   
  8.        Revision 2.97
  9.        February 1993
  10.    
  11.    
  12.        ------------------------------------------   
  13.    
  14.    
  15.    
  16.        Copyright 1990-1993 by RTFM Software and Richard W. Turenne
  17.        Winnipeg, Mb.  All Rights Reserved   
  18.    
  19.    
  20.    
  21.        All users are granted a limited license to try QCom for a reasonable  
  22.        evaluation period to determine its' suitability.   
  23.    
  24.    
  25.        QCom is USER SUPPORTED.  It is not Public Domain and is not free.   
  26.        This means, if you decide to use this program, please show your   
  27.        support by registering it with the author.   
  28.    
  29.    
  30.        To add INCENTIVE, those who register will be shown how to utilize   
  31.        the user defineable functions.  Users can pre-define other   
  32.        external dos functions, or other external protocols, or batch files,  
  33.        and access them with a single keystroke.  Additionally, they will be  
  34.        able to eliminate the "nag" screen when ending QCom.   
  35.    
  36.    
  37.    
  38.    
  39.    
  40.        ------------------------------------------------------------------   
  41.    
  42.    
  43.    
  44.    
  45.    
  46.    
  47.    
  48.    
  49.    
  50.    
  51.    
  52.                                   -Page 1-    
  53.    
  54.   SYSTEM REQUIREMENTS:   
  55.    
  56.      Minimum of one floppy drive, 256K or more memory, and a modem of   
  57.      course.   
  58.    
  59.    
  60.   INTRODUCTION to QCom:   
  61.    
  62.      QCOM is a compact communications program that attempts to pack in   
  63.      maximum of function, form and ease of use into a small package.  It   
  64.      was decided to primarily use external protocols for files transfers   
  65.      because there are many available from which to choose.  And as the   
  66.      technology of protocols progresses, it's a simple matter to keep your   
  67.      communication software operating at the current state of the art.   
  68.    
  69.      Note: All references to DSZ also apply to GSZ by Omen Technology.   
  70.    
  71.      QCOM is tailored to use the shareware program DSZ by Omen Technology   
  72.      to handle most file transfers.  When a file is to be transferred,   
  73.      QCOM passes the proper commandline to DSZ which then handles all the   
  74.      work of transferring and error checking.  It provides commonly used   
  75.      Xmodem, Ymodem and Zmodem transfer methods.   
  76.      (QCom can also be set up to use any other external protocol. See the   
  77.      section on OTHER EXTERNAL PROTOCOLS.)   
  78.    
  79.      When the file transfer is finished, QCOM resumes control.   
  80.      NOTE:   
  81.      DSZ.COM  must be present in the default directory or in the DOS   
  82.      path if you wish to transfer files.  DSZ or GSZ  may be obtained from   
  83.      many local online sources.   
  84.    
  85.    
  86.    
  87.    
  88.    
  89.    
  90.    
  91.    
  92.    
  93.    
  94.    
  95.    
  96.    
  97.    
  98.    
  99.    
  100.    
  101.    
  102.    
  103.                                   -Page 2-    
  104.   FIRST TIME SETUP AND CONFIGURATION:   
  105.    
  106.     Run the QCom Setup utility called QS.EXE.  Enter Com Port, screen   
  107.     colors and select your modem from the list.  Pressing ENTER will   
  108.     update the QCom configuration file.  Follow any instructions   
  109.     relating to modem switches or jumpers.   
  110.    
  111.     Run QCOM.  Wait a few moments while the modem is being initialized.   
  112.     An error message usually means the modem has not been properly   
  113.     initialized.  Correct modem initialization is critical to all   
  114.     operations that involve the modem.  If the string from QCom Setup   
  115.     is incorrect, please advise the author so that corrections can be   
  116.     made.   
  117.     In the mean time, you may need to refer to your modem instruction   
  118.     manual if you still have problems.  One way to check initialization   
  119.     is to press ALT-M when at the terminal screen to reinitialize the   
  120.     modem. If you get "ERROR" back from the modem then there is something in 
  121.     the string that it doesn't understand. Refer to your modem manual to   
  122.     remove any incorrect modem commands from the string.  Pressing ALT-O   
  123.     when in QCom allows you to edit the modem string contained in the   
  124.     configuration file.  Also see the Trouble Shooting section that   
  125.     follows later.   
  126.    
  127.     All configuration data is stored in the text file called QCOM.CFG.   
  128.     If you wish, you can edit the file with any ascii editor as long as a   
  129.     few rules are adhered to:   
  130.    
  131.     a)The sequence and number of items in the file must not be altered.   
  132.    
  133.     b)Each line should be no longer than 80 characters.  Longer lines   
  134.       are truncated to 80 characters.   
  135.    
  136.     c)Comments, if used, must be kept behind semicolons.   
  137.    
  138.     d)The editor must not insert any hidden formatting or control   
  139.       characters into the text.  If in doubt about your editor, edit it   
  140.       within QCom using ALT-O.   
  141.    
  142.     NOTE:   
  143.     The "|" character will send a carriage return to the modem.  The   
  144.     "~" is a half-second pause to allow the modem time to execute the   
  145.     commands in the initialization string.  Some modems need more time   
  146.     than others.  The pause is executed by QCom and the modem will not   
  147.     actually receive the "~" character.   
  148.     Function key definitions are shown in the last ten lines.  You can   
  149.     configure your own "macros" here.  Control codes can be sent with   
  150.     the use of the "^" character.   
  151.     Example:           ^[ = an escape character   
  152.                        ^M = a carriage return   
  153.     Refer to any good ASCII chart for others.   
  154.                                   -Page 3-    
  155.   COMMANDLINE PARAMETERS:   
  156.    
  157.     In addition to specifying a script,  the user can specify an   
  158.     alternate configuration file and an alternate phone directory file.   
  159.     This allows network users to have CFG and FON files tailored to   
  160.     their individual needs.   
  161.    
  162.     Switches are:   
  163.            /S = load and execute script file   
  164.            /C = load alternate configuration file   
  165.            /P = load alternate phone directory   
  166.            /B = force monochrome  
  167.     Usage is: QCOM [/Sfilename.SCR] [/Cfilename.CFG] [/Pfilename.FON] [/B]  
  168.    
  169.     Users may use the options in any sequence.  The switches (/S,/C,/P)   
  170.     must NOT have a space preceding the filename.  When the commandline   
  171.     options are not used, QCom defaults to QCom.CFG and QCom.FON.   
  172.    
  173.   TERMINAL EMULATION:   
  174.    
  175.     This version has built-in support for ANSI-BBS and straight TTY.   
  176.     Pressing ALT-K will toggle between the two.   
  177.    
  178.   STATUS LINE EXPLANATION:   
  179.    
  180.     ----------------------------------------------------------------------   
  181.     Alt-Z:Help SEC  Host system name     Online 05:55:55 Z COM1:2400N8   
  182.     ----------------------------------------------------------------------   
  183.         |       ||||         |                |       |     |       |   
  184.         |       ||||         |                |       |     |       |   
  185.     Commands    ||||         |                |       |     |       |   
  186.     Script on -- |||         |                |       |     |       |   
  187.     Echo On ----- ||         |                |       |     |       |   
  188.     Capture On --- |         |                |       |     |       |   
  189.     Alarm Off -----          |                |       |     |       |   
  190.     Host name ---------------                 |       |     |       |   
  191.     Carrier status ---------------------------        |     |       |   
  192.     Time connected -----------------------------------      |       |   
  193.     Transfer protocol --------------------------------------        |   
  194.     Communication port, baud, parity and databits ------------------   
  195.    
  196.    
  197.    
  198.    
  199.    
  200.    
  201.    
  202.    
  203.    
  204.    
  205.    
  206.                                   -Page 4-    
  207.   FILE TRANSFER PROTOCOLS:   
  208.    
  209.     Transfer protocols are what DSZ uses as a method of flow-control and   
  210.     error-checking when transferring files.  These protocols are   
  211.     specified when adding to the Dialing Directory.  The Dialing   
  212.     Directory is displayed when you press ALT-D.   
  213.     The use of ZModem protocol is recommended if the host computer has   
  214.     the option available.  QCom defaults to ZModem with crash recovery   
  215.     and Moby Turbo enabled (z-rm).  This can be changed by bringing up   
  216.     the configuration screen with ALT-O and editing the default ZModem   
  217.     line.   
  218.     When selecting XModem protocol, QCom defaults to using the built-in   
  219.     XModem instead of DSZ's. This can be changed by editing the   
  220.     appropriate line in QCom.CFG (press ALT-O in QCOM).   
  221.    
  222.     If it becomes necessary to change your transfer protocol while on-   
  223.     line, you can do so by pressing ALT-T.  A box will pop up to allow   
  224.     you to make the change.  The current protocol is displayed in the   
  225.     right-hand box on the status line (see STATUS LINE EXPLANATION   
  226.     below).  It is VERY important that the protocols at the receiving and   
  227.     transmitting ends are the same, otherwise DSZ will give a "Time Out"   
  228.     error message and abort without transferring anything.   
  229.    
  230.     Finding the required information on setting protocols in the DSZ   
  231.     documentation can be challenging.  QCom gives the user a menu to   
  232.     simplify selection and will send the command string that DSZ looks   
  233.     for.  The following show the protocol commands QCom sends to DSZ.   
  234.    
  235.     Protocol:        DSZ Command string:   
  236.     ZModem            "z -rm" (Can be changed in QCom.CFG)   
  237.     YModem Batch      "b -cy"   
  238.     YModem-G          "b -cgy"   
  239.     XModem-CRC        "x -cy"   
  240.     XModem-1K         "x -cky"   
  241.     XModem-1K-G       "x -cgy"   
  242.    
  243.     The command that QCom gives to DSZ is the port and CONNECT baud rate   
  244.     currently in use,  followed by an "s" or an "r" (depending on whether   
  245.     the file is being sent or received) and the protocol string as in the   
  246.     above  examples.   
  247.     TIP: Other options can be added by using SET DSZOPT=options in the   
  248.     autoexec.bat file.  See the DSZ docs for options.   
  249.    
  250.     The download path is added to the end of the  commandline when   
  251.     downloading.  An unregistered copy of DSZ will ignore download paths.   
  252.     The upload path precedes the filename specified by the user when the   
  253.     upload command is issued.   
  254.    
  255.     TIP:  If you upload files from different sub directories, keep the   
  256.     default upload path blank in the QCom.CFG file.  When prompted for   
  257.     the file to upload, enter the path and filename together   
  258.     (Eg. C:\QCOM\QCOM.ZIP").   
  259.                                   -Page 5-    
  260.   FILE TRANSFER PROTOCOLS CONTINUED...   
  261.    
  262.     Another tip:  Put the line "SET DSZLOG =C:\QCOM\QCOM.LOG" in your   
  263.     Autoexec.bat file and DSZ will keep a log of your file transfers in   
  264.     QCOM.LOG (This assumes that you have installed QCom on drive C: in a   
  265.     subdirectory \QCOM.  You may change the path and log filename as you   
  266.     wish.).   
  267.     File transfers may be aborted with ESC followed by several CTRL-   
  268.     BREAK's.   
  269.    
  270.   OTHER EXTERNAL PROTOCOLS:   
  271.    
  272.     QCom can be set up to use most external protocols.  Non-registered   
  273.     uses can jump to Dos (ALT-J) and manually execute the external prot-   
  274.     ocol.  Registered users will be shown how to pass parameters to the   
  275.     external protocols and execute them with a single keystroke.   
  276.     Note: An unregistered copy of QCom is not "crippled".  The instruct-   
  277.     ions for using this feature of QCom are provided to all those who   
  278.     register.   
  279.    
  280.   SCREEN COLORS:   
  281.    
  282.     Screen colors can be changed by modifying values given in the   
  283.     configuration file QCom.CFG.  The easiest way is to use QS.EXE, the   
  284.     QCom Setup program.   
  285.    
  286.   VARIOUS FUNCTIONS:   
  287.    
  288.     ALT-A:   
  289.          Toggles the sound functions on or off.   
  290.     ALT-B:   
  291.          Allows the user to scroll back up to 500 lines of received data.   
  292.          Search capabilities are provided for finding particular text and   
  293.          the whole buffer can be written to disk using the Save command,   
  294.          "S" (the filename defaults to "QComBuff.Txt") or erase the buffer   
  295.          with "E". "Q" is for quoting previously received text. When "Q" is  
  296.          pressed another menu of choices is presented and one line of text   
  297.          will be highlighted. This highlighted line can be moved through   
  298.          the buffer with the cursor keys, Home, End, PgUp, or PgDn.  Lines   
  299.          can be tagged or untagged by pressing "T" or the SPACE bar.  Once   
  300.          text is selected, it can be save to disk with "F" or immediately   
  301.          sent to the host with "S".  This last feature allows you to quote   
  302.          lines from a message and return them to the host's editor when   
  303.          answering that message online.  "U" will untag all tagged lines   
  304.          as will sending or filing.   
  305.     ALT-C:   
  306.          Communication parameters can be modified here.  These changes   
  307.          are in effect until changed again or until QCom ends.   
  308.          Com Port must be set in QCOm.CFG. Port changes will not take   
  309.          effect unless QCom is restarted.   
  310.    
  311.    
  312.                                   -Page 6-    
  313.   VARIOUS FUNCTION CONTINUED...   
  314.    
  315.     ALT-D:   
  316.          Displays the dialing directory.  Use the arrow keys to select   
  317.          a number and ENTER to dial that number.  Other keys that are   
  318.          PGUP, PGDN, HOME and END.  HOT TIP: Pressing ALT and a letter   
  319.          will put the cursor on the first line beginning with that   
  320.          letter.   
  321.          Add a new entry with "A" or edit an existing one with "E".  To   
  322.          delete an entry press "D".  You can dial the phone with a   
  323.          manually entered number using "M".   
  324.          Phone entries can be tagged or untagged with the Space bar.   
  325.          This will cause QCom to continuously dial all tagged numbers   
  326.          until a connection is made.  Dialing of tagged numbers will   
  327.          commence when the Enter key is pressed.  Once a connection is   
  328.          made and broken you will be returned to the Dialing Directory.   
  329.          Continuous dialing will resume where it left off if Enter is   
  330.          pressed again.   
  331.     ALT-E:   
  332.          Toggles local echo on or off.  This is used when the host does   
  333.          not echo back the characters that you enter.  An "E" is   
  334.          displayed in the left-hand box on the status line when local   
  335.          echo is on.   
  336.     ALT-F:  
  337.          Toggles adding linefeeds to incoming and outgoing lines.  
  338.     ALT-G:   
  339.          Toggles output to printer on and off.  Allows all incoming text to  
  340.          be sent to the printer.  Make sure the printer is online.   
  341.     ALT-H:   
  342.          Sends the hang-up string to the modem and toggles DTR.   
  343.     ALT-I:   
  344.          Will save the current screen image to a text file as specified   
  345.          in the QCom.CFG file.  Default filename is QCOM.SCN which can   
  346.          be changed by editing the QCom.CFG file (use ALT-O).   
  347.     ALT-J:   
  348.          Allows shelling out to DOS without ending QCOM.  External   
  349.          programs can be executed while on-line.  The user could make   
  350.          use of other external file transfer protocols here if desired.   
  351.          Though there is a better way.  See registration section.   
  352.     ALT-K:   
  353.          Toggles between ANSI and TTY terminal emulation.   
  354.     ALT-L:   
  355.          Toggles the "capture" function.  If on, all incoming text will   
  356.          be saved in a file named as specified in the QCom.CFG file.   
  357.          Default is QCOM.CAP.  IF the file  does not exist in the   
  358.          default directory, it will be created.  Otherwise data is   
  359.          appended to an existing capture file.  A "C" is displayed in   
  360.          the left-hand box on the status line when capture is on.   
  361.     ALT-M:   
  362.          Sends the modem initialization string to the modem.  This   
  363.          string is automatically sent upon start-up (providing no   
  364.          carrier is present).   
  365.                                   -Page 7-    
  366.  VARIOUS FUNCTIONS Continued...   
  367.    
  368.     ALT-N:   
  369.          Split-screen separates incoming and outgoing keystrokes   
  370.          during a "chat" session.   
  371.     ALT-O:   
  372.          Brings up the QCOM.CFG file to the screen for editing.   
  373.          Press F10 to save the file and to set the Communication   
  374.          parameters as shown in the file.  Esc exits and makes no   
  375.          changes.   
  376.          If it were necessary to change baud or any other Communication   
  377.          parameter while online, use ALT-O to edit and F10 to set   
  378.          parameters.  Changing the port specified here will have no   
  379.          effect unless QCom is  restarted.   
  380.     ALT-P:   
  381.          Sends the current password from an entry of the Dialing   
  382.          directory when you have dialed and connected to that entry.   
  383.     ALT-Q:   
  384.          Load and execute a script.   
  385.     ALT-R:   
  386.          Re-dials the last phone number dialed when no entries are   
  387.          "Tagged", or if entries are "Tagged", it will continue dialing   
  388.          those.   
  389.     ALT-S:   
  390.          Toggles the Script Save function.  See the Script section for   
  391.          more information on making and using scripts.   
  392.     ALT-T:   
  393.          Allows changing of the transfer protocol currently in effect.   
  394.          This can be done while on-line.   
  395.     ALT-V:   
  396.          Allows the use of an external editor or file viewer.  The   
  397.          editor (or file viewer) of choice is defined in the   
  398.          configuration file.   
  399.     ALT-U:   
  400.          Will send a pure ascii text file to the host with no error-   
  401.          checking.  Ascii transfer is used to send a text file to the   
  402.          host PC.  For example, you might use it when sending a message   
  403.          to an electronic mail service.  Instead of editing the message   
  404.          on-line, you can prepare your message in advance.  Once on-   
  405.          line, go into the message editing screen on the host and then   
  406.          use ALT-U to upload your file.   
  407.     ALT-W:   
  408.          Wipes the screen clear.   
  409.     ALT-X:   
  410.          Ends QCOM.   
  411.    
  412.    
  413.                                   -Page 8-    
  414.   VARIOUS FUNCTIONS Continued...   
  415.    
  416.     ALT-Y:   
  417.         QCom becomes the host computer.  It will wait for any incoming   
  418.         phone calls until ESC is pressed.  When a call is received, QCom   
  419.         will answer the phone.  QCom sends the file HELLO.HOS 
  420.          to the caller's PC.  You can edit this file to suit your own   
  421.          needs using an ANSI "editor" like TheDraw.   
  422.          After this message file is sent, the caller is shown the   
  423.          menu contained in the file "MENU.HOS" 
  424.     
  425.          The caller can select one of the choices or the Host can enter   
  426.          selections.   
  427.          "Help"  sends a brief help screen, HELP.HOS to the user.   
  428.          "Area"  allows the user to change to a different subdirectory.   
  429.          When a caller selects the Area command, a file called AREAS.HOS   
  430.          is displayed on the caller's screen.  This is intended to show   
  431.          which "areas" (subdirectories in fact) the caller can have access    
  432.          to. A sample AREAS.HOS file is included.  Users will want to edit  
  433.          this file to suit their systems.  
  434.          "Files" allows the user to list specified files in that   
  435.          subdirctory.   
  436.          "Chat"  will allow  a dialogue between each PC.  To end Chat   
  437.          and return to the menu, the Host must press ESC.   
  438.          "Upload"  will send a file to the Host using DSZ ZModem.   
  439.          "Download" will send a file to the caller in a similar manner.   
  440.          If the caller specifies the correct path and filename, he will   
  441.          be able  to download a file from anywhere on the Host system.   
  442.          "Proto" will allow the caller to select XModem, YModem or   
  443.          ZModem protocols when transferring files.   
  444.          "Goodbye" will send BYE.HOS and terminate the connection .   
  445.          As Host, you can also terminate the call by pressing ALT-H to   
  446.          hangup. QCom will then wait for the next caller.  ALT-X will   
  447.          also terminate the call and in addition, end QCom.   
  448.          A local Host mode test is available: Press ENTER when waiting   
  449.          for incoming calls.  This allows preparation and preview  of   
  450.          your own host welcome messages or help screens.   
  451.    
  452.      PGUP:   
  453.          Uploads (sends) a file to the other system.  You will be   
  454.          prompted to enter a filename to upload.  The file can be   
  455.          preceded by a path only if NO upload path is specified in   
  456.          QCOM.CFG.  If the host supports batch uploads then you can   
  457.          take advantage of DSZ's capabilities; when prompted for a file   
  458.          to upload enter the name of a file containing a list of the   
  459.          files you wish to upload.  Precede the filename with an "@" .   
  460.          Example: "@files.lst".  Or you can use QCom to create a list   
  461.          file for you.  When prompted for a file to upload press ENTER   
  462.          with any global file specification (*.* or *.zip). You will   
  463.  
  464.  
  465.                                   -Page 9-  
  466.   
  467.  
  468.   VARIOUS FUNCTIONS CONTINUED...    
  469.          be shown a box containing filenames based on that specification.   
  470.          From here simply use the cursor keys to select a files and Mark   
  471.          them with "M".  When finished marking press ENTER and QCom will   
  472.          create "Files.LST" and pass that to DSZ for you.   
  473.    
  474.      PGDN:   
  475.          Downloads (receives) a file from the host computer.  If XModem   
  476.          or YModem are the protocols in effect, you'll be prompted to   
  477.          enter the filename to receive.  QCom tries to guess the   
  478.          filename based on recently entered text and places its' guess   
  479.          at the prompt.   
  480.          If ZModem is in effect, entry of filenames is not required and   
  481.          in fact, pressing PGDN is not required because QCom will call   
  482.          DSZ automatically when it receives the Zmodem Receive string.   
  483.      ALT-=:   
  484.          Toggles "Doorway" mode.  This removes the status line when in   
  485.          Doorway mode and gives full screen display for using remote   
  486.          applications.   
  487.          Allows you to make full use of all keys while online.  All   
  488.          Alt-key combinations except ALT-= are sent out and their usual   
  489.          functions are disabled in this mode.   For example, PgUp,   
  490.          PgDn, Home, End and the cursor key codes are transmitted.  You   
  491.          might make use of this when using a full-screen editor while   
  492.          online or when using your PC as a dumb terminal on a non-DOS   
  493.          system such as Unix.  Status line and all key functions are   
  494.          restored when Doorway mode is turned off.   
  495.      ALT-Minus:   
  496.          Enables/disables debugging during script execution.  Status   
  497.          line displays the next line of text which QCom is looking for.   
  498.      Ctrl-END   
  499.          Sends Break signal to host.  Used for terminating some mainframe   
  500.          connections.   
  501.      F1-F10:   
  502.          Sends the text as listed in the last ten lines of QCom.CFG.   
  503.          You can put your name, password, special key codes or whatever   
  504.          you wish here. 80 characters max on each line.   
  505.      Ctrl-F1   
  506.          Displays the "Function Key Macros" as they appear in QCom.CFG.   
  507.      Ctrl-F2   
  508.          Displays the "Alt Key Macros" for registered users.   
  509.    
  510.    
  511.    
  512.    
  513.    
  514.    
  515.    
  516.    
  517.    
  518.                                   -Page 10-    
  519.    SCRIPTS:   
  520.        Scripts are used for automating repetitive tasks such as dialing,   
  521.        logging in to an online service, and transferring files or     
  522.        electronic mail.  A script is generally made up of a series of    
  523.        commands for QCom to execute at the appropriate time.  The script    
  524.        can tell QCom to send text to the host or it can make QCom execute    
  525.        one of its' internal functions.   
  526.    
  527.    MAKING A SCRIPT:   
  528.       QCom has a built-in Script-save feature to simplify the creation of   
  529.       scripts. To create a typical login script you would do the    
  530.       following:   
  531.       1.  From the Dialing Directory dial the number.   
  532.       2.  When the host answers and immediately after the Dialing box   
  533.           clears, press Alt-S to start the script saver.  It will prompt    
  534.           you to enter the name of your script.  If, for example, you're    
  535.           calling CompuServe, you could name it CIS.SCR.   
  536.       3.  QCom will save each line of incoming text which prompts you for   
  537.           input.  For example the host may prompt you...   
  538.                    ENTER YOUR FULL NAME :   
  539.           To which you respond by typing in your name and pressing ENTER   
  540.           when the name is complete.  Always type entries in, don't use   
  541.           Function key macros when saving a script. If/when prompted to   
  542.           press "ANY" key always press ENTER.  QCom will store the host's   
  543.           prompt, and the text you have entered in the script.   
  544.           (Also Note: BBS software that has "HotKey" menu choices where    
  545.           the user is not required to press ENTER after selecting a letter    
  546.           is great BUT... when it comes to saving a script QCom will NOT    
  547.           save the line unless you press ENTER.  So when saving a script    
  548.           turn off the Hotkey feature at the BBS end.)   
  549.       4.  QCom will also store any commands you give it such as ALT-L   
  550.           to turn on the capture function.   
  551.       5.  When you wish to stop saving a script press Alt-S again.   
  552.       6.  To have this new script execute when you call this number again,   
  553.           add the name of your script into that entry in the Dialing   
  554.           Directory. The next time you dial that number the script will be   
  555.           loaded and executed.   
  556.    
  557.       Sample script :   
  558.       put a message on screen   
  559.       ;ECHO ^M This is the start of my script! ^M   
  560.    
  561.       let's capture the session to file.txt   
  562.       ;a-L file.txt   
  563.    
  564.       Do you want graphics (Enter)=no;^M   
  565.       What is your full name?;John Doe^M   
  566.    
  567.       sends password from the Directory entry we just dialed   
  568.       Password (Dots will echo)?;a-P   
  569.       Scan Message Base Since 'Last Read' (Enter)=yes;^M   
  570.       Press (Enter) to continue;^M   
  571.                                   -Page 11-    
  572.    
  573.    MAKING A SCRIPT Continued...   
  574.    
  575.       receiving (downloading) a file   
  576.       min. left) Main Board Command?;d^M   
  577.       Filename to Download (Enter)=none?;file.arc^M   
  578.    
  579.       downloads "file.arc"   
  580.       ;D/L file.arc   
  581.       Press (Enter) to continue;^M   
  582.    
  583.       goodbye   
  584.       min. left) Main Board Command?;g^M   
  585.    
  586.       give hangup command   
  587.       ;a-H Y   
  588.    
  589.       execute another script   
  590.       ;a-Q MyBBS.SCR   
  591.    
  592.       The following is an example of a script that connects to   
  593.       CompuServe through the DataPac network.   
  594.    
  595.       ;ECHO  Logging in to CompuServe.  Please wait...   
  596.    
  597.       send "..." when connected   
  598.       ;...^M   
  599.    
  600.       send node id number when the word DATAPAC is received   
  601.       DATAPAC;P 12345678^M   
  602.    
  603.       CompuServe Information Service   
  604.       Host Name:;CIS^M   
  605.    
  606.       insert your user ID   
  607.       User ID:;12345,6789^M   
  608.    
  609.       send password from dialing directory   
  610.       Password:;a-P   
  611.    
  612.       check for mail or whatever   
  613.       Enter choice!;5^M   
  614.       etc, etc.   
  615.    
  616.       See the included file QCOM.SCR for more examples on scripting.   
  617.    
  618.       Note: When saving a script, QCom saves every line of incoming text on   
  619.       which the user is prompted for input AND which is terminated with a   
  620.       carriage return ( by pressing the ENTER key).  Any line that prompts   
  621.       the user and does not require the ENTER key to be pressed, will NOT   
  622.       be saved in the script.  Such lines would have to be manually typed   
  623.       into the script with a text editor.   
  624.                                   -Page 12-    
  625.    MAKING A SCRIPT Continued...   
  626.    
  627.       In order to use a script automatically, put the name of the   
  628.       script file in the SCRIPT column in the Dialing Directory.   
  629.       One way to create a new script is to capture a session and then   
  630.       edit it to conform to the above format, using the semicolons to   
  631.       separate incoming and outgoing text.  Any unnecessary text can be   
  632.       deleted from the capture file (such as news bulletins, etc.).   
  633.       Rename the file using ".SCR" as the extension in your script   
  634.       filename.   
  635.    
  636.    COMMANDLINE SCRIPTS:   
  637.    
  638.       Commandline scripts allow you to start Qcom, dial a number, transfer   
  639.       files, hangup and end Qcom automatically.   
  640.    
  641.       To create such a COMMANDLINE script, run Qcom, press ALT-S before   
  642.       going into the Dialing Directory .  Enter the name of your script,    
  643.       and proceed to step the program through the whole dialing and    
  644.       connection procedure.  Qcom will save your commands as well as the    
  645.       text coming in and going out.   
  646.    
  647.       To execute this script from the commandline use:   
  648.    
  649.       "QCom /SMyScript.scr"   
  650.    
  651.       The "/S" tells QCom that the following is the name of a script to   
  652.       execute. You must use the full script filename.   
  653.       When a script is executing you will see an upper case "S" on the   
  654.       Status line.  To stop script execution at any time, press ESC.   
  655.    
  656.       Note:   
  657.       When your script dials a directory entry that has another script   
  658.       specified, the second script will be ignored.  You can, however,   
  659.       call another script by using the ALT-Q command.   
  660.       (eg. ";a-Q ANOTHER.SCR").   
  661.    
  662.    SCRIPT COMMANDS:   
  663.    
  664.       Most Script commands consist of shorthand for the keystrokes   
  665.       you would use when manually running QCom.  The ALT-Key commands   
  666.       that QCom understands can be entered into a script with  ";a-"   
  667.       followed by the letter you wish to use. Eg. ALT-P would be ";a-p".   
  668.       Upper or lower case will work.   
  669.    
  670.       Exceptions: ALT-- (ALT-Minus) and ALT-= cannot be saved or executed   
  671.       in a script.   
  672.    
  673.    
  674.    
  675.    
  676.    
  677.                                   -Page 13-    
  678.    SCRIPT COMMANDS CONTINUED...   
  679.    
  680.       The following are script commands that may be manually added to   
  681.       scripts.  These are NOT included in Saved scripts.   
  682.    
  683.       "ANY"     - used to send a given response to text that is received   
  684.                 repeatedly.   
  685.                 eg. ;ANY Press any key;^M   Whenever "Press any key" is   
  686.                 received, a carriage return will be sent. This will remain   
  687.                 in effect until the ANY command is used again in the script   
  688.                 to specify new incoming text.   
  689.                 eg. ANY   
  690.                 This effectively "turns off" a previous ANY command. QCom   
  691.                 will no longer respond to the previously specified incoming   
  692.                 text.   
  693.    
  694.      "DEBUG ON" -used in script debugging   
  695.                 The Status line shows which line of incoming text the    
  696.                 script is waiting for. This allows you to compare a script    
  697.                 line to actual received text to check for spelling errors    
  698.                 or typos in cases where a script is not working properly.   
  699.                 Pressing ALT-V during a debug session will load your script   
  700.                 into your editor so you can make corrections on the fly.   
  701.    
  702.      "DEBUG OFF" -disables the debug function.   
  703.    
  704.      "ECHO"     -prints text on the local screen.   
  705.                 eg. ";ECHO Please wait. Auto Logon in progress..."   
  706.                 Text can be colorized and positioned on screen   
  707.                 using ANSI escape codes.   
  708.    
  709.      "LOG"      - will save date, hostname, start time and duration   
  710.                 of calls in optional specified filename. If no log file   
  711.                 is specified, QCom defaults to "USAGE.LOG".   
  712.                 eg. ";LOG CIS.LOG"  could store a log of calls to   
  713.                 CompuServe. Also provided is a utility to total the   
  714.                 durations of calls, named QTT.EXE. Usage: QTT LogFile.   
  715.    
  716.      "WAIT"     - will pause the execution of a script for a specified   
  717.                 number of seconds.  Eg. ";WAIT 5"  will pause everything   
  718.                 for five seconds.  Do not pause for too long if you expect   
  719.                 to have incoming data during this time.  Hitting any key   
  720.                 will terminate a pause and continue the script.   
  721.    
  722.      "DOS"      Allows you to shell to Dos and execute batch files or   
  723.                 whatever.  Use the /WAIT switch after the commandline if   
  724.                 you wish to pause the display before returning to QCom.   
  725.                 eg:   
  726.                 ;DOS vampire.bat /WAIT   
  727.    
  728.    
  729.    
  730.                                   -Page 14-   
  731.   SCRIPT COMMANDS CONTINUED...   
  732.    
  733.       "ASK"     Used to get user input from the keyboard.  This will display  
  734.                 your "User Prompt" in a box and wait for user input.  When    
  735.                 the user presses Enter, QCom will compare the user's input    
  736.                 to the text in "Answer". If it is the same then the script    
  737.                 will go to the "Label". Otherwise the script will continue    
  738.                 with the next line. Use commas to separate the prompt,    
  739.                 answer and label.    
  740.                 Usage: ;ASK User Prompt ,Answer,Label    
  741.                 eg:   
  742.                 ;ASK Download your mail? (Y/N) ,Y,DownLoad Mail   
  743.                 ;GOTO No Download   
  744.                 :DownLoad Mail   
  745.                 ;...   
  746.    
  747.       "GOTO"    To branch to another part of the script.   
  748.                 eg:   
  749.                 ;GOTO Label 1   
  750.                 or...   
  751.                 When this text is received;GOTO Label 2   
  752.    
  753.       "CALL"    To go to another part of the script and execute until the    
  754.                 RET (Return) command is encountered. It returns to the line   
  755.                 following the Call. Calls can be nested 255 levels.   
  756.                 eg:   
  757.                 When this text is received;CALL Label 3   
  758.                 or...   
  759.                 ;Call Label 3   
  760.                 ;END   
  761.                 :Label 3   
  762.                 Look for this text;send something^M   
  763.                 ;RET   
  764.    
  765.       "RET"     As above, used to return from a CALL. A RET must not be    
  766.                 executed unless a CALL has been executed first. RET cannot    
  767.                 be used with GOTO.   
  768.                 Usage: ;RET   
  769.    
  770.       "T/O"     Timeout for incoming text.  A given timeout value will apply  
  771.                 to any script line waiting for incoming text which follows    
  772.                 the T/O command.    
  773.                 To enable timeout use: ;T/O Seconds   
  774.                 To disable timeout use: ;T/O 0   
  775.       
  776.         Example:   
  777.                 ;T/O 10   
  778.                 Wait for text for 10 seconds;Send if received before 10 secs  
  779.                 Otherwise wait for this for 10 seconds;...etc.   
  780.                 Disable timeout:   
  781.                 ;T/O 0    
  782.                                   -Page 15-      
  783.   SCRIPT COMMANDS CONTINUED...   
  784.        
  785.       "ENQ"     Have QCom do something upon receiving an ENQ character (^E).  
  786.       A typical use would be when transferring a file on Compuserve using   
  787.       the QuickB protocol. The following example shows how to have QCom   
  788.       shell out to OZBext (an external QuickB protocol) to transfer a file   
  789.       on Com port 2 when the ENQ character is received.   
  790.       Eg:  ENQ;DOS OZBext /c2 /x    
  791.    
  792.       Registered users may use port and file abbreviations, etc., where    
  793.       appropriate, as per their instruction sheet.   
  794.       After QCom receives this ENQ it stops looking for further ENQ's.   
  795.        
  796.       "END"    Used to stop script execution.   
  797.             eg:   
  798.             ;END   
  799.             or...   
  800.             When this text is received;END    
  801.  
  802.       "TAG" Used for tagging or marking Dialing Directory entries for 
  803.             dialing.
  804.             eg:
  805.             ;TAG PCUG 
  806.             QCom will tag or mark all Dialing Directory entries starting with  
  807.             "PCUG". To tag only one of several entries with similar names it is 
  808.             necessary to have something unique in the name you wish to tag.
  809.             eg: ";TAG PCUG Node 1"
  810.  
  811.             Note : When entries have been tagged with the above TAG command,   
  812.             use the DIAL command without a specified name.
  813.             eg:
  814.             ;TAG PCUG
  815.             ;DIAL
  816.             This will cause QCom to dial all tagged entries until a connection 
  817.             is made.
  818.     
  819.        "UNTAG" QCom will untag all marked Dialing entries.
  820.             eg:
  821.             ;UNTAG
  822.   
  823.       The following are script commands that may be manually added to   
  824.       scripts.  These ARE included in Saved scripts.   
  825.    
  826.       "DIAL"    -dials the entry specified. Eg. ";DIAL CompuServe"   
  827.       "U/L"     -uploads the specified file Eg. ";U/L Myfile.Zip"   
  828.       "D/L"     -downloads the specified file Eg. ";D/L Myfile.Zip"   
  829.       "BREAK"   -sends a BREAK signal to the host Eg. ";BREAK"   
  830.  
  831.  
  832.  
  833.  
  834.  
  835.                                    -Page 16-
  836.    
  837.    Labels:   
  838.       Like labels in batch files, a label is preceded by a colon and can   
  839.       consist of one or more words or numbers.  No semi colon is used as   
  840.       in other script lines.   
  841.       eg:   
  842.       :Label 1   
  843.       :Label 2   
  844.    
  845.    SEMICOLONS:       
  846.       In a QCom script, the semicolon is all important. It divides each   
  847.       line into incoming and outgoing text. Lines beginning with a semi-   
  848.       colon are commands that QCom will execute (such as an ALT-Key   
  849.       command).   
  850.       Also note that only the first semicolon is used as a divider.   
  851.       Subsequent semicolons are treated as regular text.   
  852.    
  853.       Any line of text in a script with no semicolon or colon is ignored    
  854.       by QCom and can be used as a comment line for clarification when    
  855.       viewing or editing the script.   
  856.    
  857.       Script execution takes place only in the terminal screen. If your   
  858.       script executes something like ALT-B (ScrollBack) or ALT-Z (Help),   
  859.       manual input will be necessary to return to the terminal screen to   
  860.       continue script execution.   
  861.    
  862.     FINAL NOTE ON SCRIPTS:   
  863.       When saving a script, incoming phone noise may be saved during a   
  864.       session and will have to be edited out before using the script.   
  865.       It's wise to double-check a newly created script for any unwanted   
  866.       characters.  Any pure text editor can be used to edit or create a   
  867.       script file.   
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.                                    -Page 17-
  890.    
  891.     TROUBLE SHOOTING:   
  892.    
  893.       Symptom:  "Cannot initialize Com Port x" error message. (x = 1 to 4)   
  894.       Meaning of error message: Qcom cannot find the Com Port that is   
  895.       specified in the configuration file (QCom.CFG).   
  896.       Possible causes:   
  897.       1. Error in configuration file.  The number specified there does not   
  898.          match the Com Port used by the modem.   
  899.       2. Hardware problem.  Two or more devices are configured for the same   
  900.          Com port or the Com port specified is not installed.   
  901.          Check that there is no conflict in hardware interrupt settings.   
  902.          If two serial devices attempt to use the same Interrupt (IRQ)   
  903.          setting chances are, neither will work. Typical settings would be:   
  904.    
  905.                            Com1 using IRQ 4, at I/O 3F8h   
  906.                            Com2 using IRQ 3, at I/O 2F8h   
  907.                            Com3 using IRQ 4, at I/O 3E8h   
  908.                            Com4 using IRQ 3, at I/O 2E8h   
  909.    
  910.       3. Software conflict. A memory resident program that ties up the Com   
  911.          port has been previously executed and has not been deinstalled.   
  912.          Carbon Copy is an example of such a program.   
  913.    
  914.       Symptom: "Modem not responding"   
  915.       Meaning of message: Modem did not respond with "OK" within the   
  916.       alotted time.   
  917.       Possible causes:  See the following:   
  918.    
  919.       Symptom: Modem does not dial out.  Modem does not receive some/all   
  920.       commands sent by QCom.   
  921.       Possible causes:   
  922.       1. Baud rate specified in the configuration file is too high for the   
  923.          modem.   
  924.          Set the default baud rate to your modem's fastest speed.  Modem   
  925.          will send back an "OK" when you initialize the modem (Alt-M) if   
  926.          all is well.   
  927.       2. External modem is not powered up or not connected properly.   
  928.    
  929.       3. Possible hardware conflicts with another installed serial device.   
  930.          Internal modem has been improperly installed or configured.   
  931.    
  932.       4. Modem initialization or dialing prefix strings are incorrect.   
  933.          Refer to the Modem instruction manual for the correct strings for   
  934.          your modem.   
  935.                                          
  936.                                   -Page 18-    
  937.    TROUBLE SHOOTING Continued...   
  938.    
  939.       5. Modem is incorrectly configured.  Refer to modem manual and set   
  940.          modem dip switches or NVRam for the following:   
  941.          a) Modem must track the actual state of DCD (Carrier) and not be   
  942.             forced.   
  943.          b) Modem should track DTR and not be forced.   
  944.          c) Modem MUST send back verbal result codes such as "OK" or   
  945.             "CONNECT", etc.   
  946.    
  947.       6. See the following   
  948.          Symptom:  QCom status line says "Online" even when not.   
  949.          Cause:   
  950.          Modem Carrier Detect line is forced on.  This MUST toggle on or    
  951.          off depending on the actual Carrier state.  This is set with a    
  952.          modem dip switch or a command sent in the initialization string.     
  953.          Refer to the modem manual.  Edit the initialization string if    
  954.          necessary and use Alt-M to manually send the string to the modem.    
  955.  
  956.          Or toggle the Carrier detect dip-switch if present.   
  957.          Many modem factories typically set this to default to always on.   
  958.          One result of this is QCom will prompt you whether you want to   
  959.          initialize the modem at start-up which is an unnecessary annoyance   
  960.          (the prompt is necessary in the instance where QCom is used as a   
  961.          dumb terminal attached directly to another machine).   
  962.    
  963.    
  964.          Symptom: Pressing Alt-M to re-initialize the modem gets back    
  965.          "ERROR" from the modem.   
  966.          Cause:   
  967.          The modem initialization string (line six in the QCom.CFG file)   
  968.          contains command(s) that the modem does not understand.  Or, the   
  969.          command string is too lengthy.  Refer to the modem manual and    
  970.          remove any command not found in the manual.  Long initialization    
  971.          strings can be broken up into two sections with "^M~~~AT" inserted   
  972.          about halfway.   
  973.    
  974.          Symptom: QCom reports "Unable to find DSZ.COM or DSZ.EXE"   
  975.          Cause:   
  976.          DSZ.COM or DSZ.EXE are not found in the default directory (the    
  977.          same directory as QCom) or in the search path.  Put DSZ into    
  978.          correct directory.   
  979.           
  980.          Symptom:Always get a fast busy signal after dialing. 
  981.          Cause:  
  982.          a) Call waiting string in Options is enabled when the feature 
  983.          is not present on the phone line.  Disable the string by erasing 
  984.          it or prefix it with a semicolon. 
  985.          b) A pause character may need to be added after the string. Most   
  986.          modems recognize a comma as a half second pause. eg:"*70,," 
  987.    
  988.                                       -Page 19-    
  989.    
  990.     ONLINE SUPPORT BBS:   
  991.    
  992.          To obtain further help, or for the latest update of Qcom, you   
  993.          can call the support BBS:   
  994.    
  995.          ************************************************   
  996.          *   Programmer's Oasis, Ph.  1-204-478-3562.   *   
  997.          ************************************************   
  998.    
  999.          
  1000.          When calling in, login as a new user with your full name and   
  1001.          password of your choice. After answering a few questions you   
  1002.          will be given the opportunity to go into the QCom area.   
  1003.          Once there you will have 30 minutes to send or receive messages   
  1004.          and download files.  Questions about QCom should be directed   
  1005.          to the author, not the Sysops.   
  1006.    
  1007.          Sysops Brian Lowe and Bernie Minuk are to be commended for   
  1008.          all their effort and enthusiasm in setting up and maintaining   
  1009.          this support area on their BBS.  Thanks guys, for doing an   
  1010.          outstanding job.   
  1011.    
  1012.       DISCLAIMER:   
  1013.    
  1014.       This software is provided "as is" without warranty either express or   
  1015.       implied.  The user assumes all responsibility in determining its'   
  1016.       usefulness and or fitness for any purpose, and assumes all risks and   
  1017.       liabilities including damages for loss of business profits, business   
  1018.       interruption, or loss of business information arising from the   
  1019.       operation of this software.   
  1020.    
  1021.    
  1022.    
  1023.    
  1024.    
  1025.    
  1026.    
  1027.    
  1028.    
  1029.    
  1030.    
  1031.    
  1032.     
  1033.   
  1034.  
  1035.   
  1036.  
  1037.   
  1038.  
  1039.   
  1040.  
  1041.                                   -Page 20-   
  1042.  
  1043.                                         
  1044.  
  1045.                                         
  1046.  
  1047.              **************************************************  
  1048.  
  1049.                               QCOM REGISTRATION  
  1050.  
  1051.                                         
  1052.  
  1053.                  If you use QCom,  please register it.  This  
  1054.                 software is the result of a great deal of time  
  1055.             and effort.  Please support its' continued development  
  1056.                           and the Shareware concept.  
  1057.  
  1058.                                         
  1059.        To add incentive, those who register will be shown how to utilize  
  1060.           the user defineable functions.  Users can pre-define other  
  1061.         external protocols, or DOS commands, and access them with a single  
  1062.                                   keystroke.  
  1063.                                          
  1064.  
  1065.               The one-time registration fee is a modest $20.00.  
  1066.               To receive a copy of the absolute latest version on  
  1067.                  disk, send an additional $5.00 to cover cost  
  1068.                  of disk, packaging and mailing.  Specify disk  
  1069.                     size desired and your current version.  
  1070.  
  1071.            A quick mailer is provided in the file called Register.  
  1072.                   
  1073.                         Send a check or money order to:  
  1074.                                      
  1075.                                 RTFM  Software  
  1076.                                 108 Egesz St.  
  1077.                                 Winnipeg, Mb. Canada  
  1078.                                 R2R 2E1  
  1079.                                     
  1080.              Your comments, questions, suggestions and bug reports  
  1081.                 are always welcome whether or not you register.  
  1082.         Drop me a note, leave a message on CompuServe I.D. 72361,3117.  
  1083.       Or, leave a message on Programmer's Oasis BBS, Ph.  1-204-478-3562.  
  1084.  
  1085.              **************************************************  
  1086.  
  1087.                                         
  1088.                                     
  1089.                                       
  1090.                                        
  1091.                         
  1092.                            
  1093.                      
  1094.                                   -Page 21- 
  1095.              
  1096.